SGI Freeware 1999 August

home *** CD-ROM | disk | FTP | other *** search

/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_objc.idb / usr / freeware / catman / u_man / cat1 / objc.Z / objc

Wrap

Text File | 1999-07-16 | 28.6 KB | 859 lines

oooobbbbjjjjcccc((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((OOOOcccctttt 22229999,,,, 1111999999997777)))) oooobbbbjjjjcccc((((1111)))) NNNNAAAAMMMMEEEE objc - Portable Object Compiler SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS oooobbbbjjjjcccc [ options ] file ... DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN oooobbbbjjjjcccc is a compiler for compiling Objective C objects into C, or directly into a binary object file (by automatically invoking an external C compiler). Command line options that are not recognized by oooobbbbjjjjcccc are passed on to cccccccc(1). ----bbbbooooeeeehhhhmmmm The preferred interface to turn on garbage collection, is to use the ----ggggcccc flag (which currently is equivalent to ----bbbbooooeeeehhhhmmmm). -boehm links against oooobbbbjjjjccccrrrrttttggggcccc....aaaa which is a version of the runtime library, compiled with -DOBJCRT_BOEHM. This option also adds the library gc.a (a mark-and- sweep garbage collector, needs to be installed for this option to work) to the list of libraries that are automatically linked into the program. ----BBBBpppprrrreeeeffffiiiixxxx Use _p_r_e_f_i_x as prefix for the bbbbiiiinnnn,,,, iiiinnnncccclllluuuuddddeeee and lllliiiibbbb directories when searching for binaries, include files and libraries. The default prefix is set to the installation directory (e.g. /usr/local). The environment variable OOOOBBBBJJJJCCCCDDDDIIIIRRRR overrides the default, and this option can be used to override the value of the environment variable, on the command line. ----cccc Produce a .o file but do not link. Equivalent to -Fo. ----CCCC When used with the -E option, this option will preserve comments in the preprocessed code. Otherwise, this option is equivalent to -Fi, i.e. generate C code, by translating Objective C into C, but do not run the C compiler to produce a .o file. ----cccchhhheeeecccckkkk Page 1 (printed 6/28/99) oooobbbbjjjjcccc((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((OOOOcccctttt 22229999,,,, 1111999999997777)))) oooobbbbjjjjcccc((((1111)))) Implemented for the binary driver objc.exe only. Forces the driver to print a command whenever it is supposed to invoke some tool using a system() call. Commands are simply printed, they are not executed. This is the default configuration of the Macintosh MPW driver. ----ccccpppplllluuuussss Use the CCCC++++++++ compiler instead of the C compiler to compile the output of oooobbbbjjjjcccc1111.... The driver will automatically select this mode oooobbbbjjjjccccppppllllssss1111 for files ending with a .cc or .mm suffix (C++ files or Objective-C compiled by C++ respectively). ----cccctttthhhhrrrreeeeaaaaddddssss Link against the runtime library oooobbbbjjjjccccrrrrtttttttthhhh....aaaa which is a thread-safe version of the oooobbbbjjjjccccrrrrtttt....aaaa runtime library (compiled with -DOBJCRT_CTHREADS). ----ddddllll Combine a number of object files into a dynamic module, to be loaded by dlopen() or similar, into a running Objective-C program. This option makes sure the necessary code is generated to automatically initialize Objective-C classes that are loaded into the program. ----ddddoooollllllllaaaarrrrssss Passes flags to the C compiler to allow dollar characters in identifiers. Only tested with GNU C. ----ddddyyyynnnnaaaammmmiiiicccc Must be specified to link a program that will load dynamic modules (modules that are built with -dl). Attempts to link against oooobbbbjjjjccccrrrrtttt....ssssoooo and oooobbbbjjjjppppaaaakkkk....ssssoooo shared runtime libraries, if those libraries can be found. -dynamic passes on -noShared to the stage 1 compiler and registers the function _objcInitNoShared as runtime initialization function. This is strictly speaking not needed on UNIX, but essential when using DLLs on Windows, so it is done on all platforms. In addition, -dynamic causes on some platforms to link Page 2 (printed 6/28/99) oooobbbbjjjjcccc((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((OOOOcccctttt 22229999,,,, 1111999999997777)))) oooobbbbjjjjcccc((((1111)))) against the necessary libraries that define dynamic linking functions. For example, on Linux it adds a -rdynamic flag. On HP-UX it passes a -E flag to the link editor. On Windows, (with the WATCOM driver), it adds a -br flag to use the DLL versions of the WATCOM runtime. ----EEEE Preprocess input and write output to the ssssttttddddoooouuuutttt.... ----FFFFlllleeeetttttttteeeerrrr Stop at the compilation stage specified by lllleeeetttttttteeeerrrr.... Letter can be one of o (-Fo is equivalent to -c), or other file suffixes such as i,c,j etc. ----ggggcccc Turn on garbage collection. Client programs compiled with this flag use +new to allocate objects (as usual), but do not have to send a -free message to destroy objects. ----gggg Produce debugging symbols and attempts to link against oooobbbbjjjjccccrrrrtttt____gggg....aaaa and oooobbbbjjjjppppaaaakkkk____gggg....aaaa runtime libraries with debug information, if they can be found. Since oooobbbbjjjjcccc is also emitting by default linetags that refer to the original source file, it is possible to step through the code using any C debugger. ----hhhheeeellllpppp Print overview of compiler switches. ----iiii Generate a TDF capsule (.j file) for use with the ttttcccccccc compiler and do not link. Equivalent to -Fj. ----IIIIddddiiiirrrr Add ddddiiiirrrr to the search path for include files. ----iiiinnnnlllliiiinnnneeeeccccaaaacccchhhheeee Generate inline cache code for calls to _imp() messenger. The inline cache messenger associates to each message expression its own cache, and will in many cases bypass the default objcrt messenger. Page 3 (printed 6/28/99) oooobbbbjjjjcccc((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((OOOOcccctttt 22229999,,,, 1111999999997777)))) oooobbbbjjjjcccc((((1111)))) It is safe to use this option to produce binary libraries of objects; the libraries can later be used both from within programs that are compiled either with or without the -inlinecache option. ----iiiimmmmppppoooorrrrtttt Pass flags to the C preprocessor to do the traditional Objective-C constructs # import and // on which we usually don't depend. Note that it's also possible to set the environment variable CPP to a preprocessor that's newline-terminated-comments capable, or to use the cvtimport(1) utility so that the flag is not needed. ----jjjjffffoooooooo Find and add a TDF library ffffoooooooo....ttttllll.... ----JJJJddddiiiirrrr Add ddddiiiirrrr to the search path for TDF libraries. ----llllffffoooooooo Find and add a library lllliiiibbbbffffoooooooo....aaaa (or corresponding shared library, depending on the system). ----LLLLddddiiiirrrr Add ddddiiiirrrr to the search path for libraries. ----mmmmaaaaiiiinnnn ffffuuuunnnnccccttttiiiioooonnnn Emit runtime initialization code as first statement in ffffuuuunnnnccccttttiiiioooonnnn.... The default function name is mmmmaaaaiiiinnnn,,,, but this can be changed using this option if it's not desirable for some reason to compile the main() function using oooobbbbjjjjcccc.... ----mmmmppppwwwwttttoooooooollll Macintosh specific. Generates an MPW tool. Sets creator type to the MPW type and adds the libraries defined in the environment variable OBJCMPWLIBS. Page 4 (printed 6/28/99) oooobbbbjjjjcccc((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((OOOOcccctttt 22229999,,,, 1111999999997777)))) oooobbbbjjjjcccc((((1111)))) ----nnnnooooBBBBlllloooocccckkkkssss Define the preprocessor symbol OBJC_BLOCKS as 0 (by default the symbol is defined as 1), and make the parser refuse to parse Objective-C blocks. See the documentation of the Block class for more information. ----nnnnooooCCCCaaaacccchhhheeee Turn off global Objective C messenger cache. This option can be used with -inlineCache. Sets the objcrt variable noCacheFlag to 1. The program can selectively turn on caching by setting the variable to 0. ----nnnnooooIIII Do not search header files in the directories of the runtime (objcrt) and of the collection class library (objpak). ----nnnnooooLLLLiiiibbbbssss Do not link against the runtime (objcrt) and the collection class library (objpak). ----nnnnooooNNNNiiiillllRRRRccccvvvvrrrr Messages to nil, the NULL Object, are handled by the nilHandler funtion. This option registers a handler that aborts the process. ----nnnnooooCCCCaaaatttteeeeggggoooorrrriiiieeeessss Do not allow (parse) categories. It is still possible to use the method addMethodsTo: instead. ----nnnnooooFFFFiiiilllleeeerrrr Do not automatically link the AsciiFiler into the program. Do not automatically generate filer code for class implementations. See the documentation on the show, storeOn and readFrom methods, and the AsciiFiler class, for more information. ----nnnnooooFFFFwwwwdddd Generate code for, and calls to, the traditional C Page 5 (printed 6/28/99) oooobbbbjjjjcccc((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((OOOOcccctttt 22229999,,,, 1111999999997777)))) oooobbbbjjjjcccc((((1111)))) messenger, ____iiiimmmmpppp(((()))),,,, instead of calls to our forwarding C messenger, ffffwwwwddddiiiimmmmpppp(((()))).... Programs compiled with -noFwd compile faster and are significantly smaller in executable size, but cannot make use of Object's ddddooooeeeessssNNNNoooottttUUUUnnnnddddeeeerrrrssssttttaaaannnndddd:::: method. Libraries and object files compiled with, or without, -noFwd can be freely mixed, but message forwarding will only work for those classes that were compiled with message forwarding turned on. ----nnnnooooPPPPoooossssttttlllliiiinnnnkkkk Allows to generate code for auto-init with compilers that are configured to generate by default code for postlink. ----nnnnooooSSSSeeeellllffffAAAAssssssssiiiiggggnnnn Do not allow self as left hand side in an assignment. This is related to the use of instance variables in factory methods. ----nnnnooooTTTTaaaaggggssss Suppress generation of line tags in temporary files. Normally, line tags as expected by the C compiler are generated to indicate the line numbers of the original source, so that diagnostics will be issued against the Objective C source, not against the generated C output. ----nnnnoooossssttttddddiiiinnnncccc Do not search header files in the standard include directories. This option is system specific, i.e. must be supported by the ccccpppppppp(1) preprocessor that is being used; it differs from the -noI option. ----OOOO Enable the optimizer. Whether it is possible to specify both -g and -O depends on the C compiler that is being used. ----oooonnnneeeeppppeeeerrrrffffiiiilllleeee Allow only one class implementation per compilation unit, as the original Stepstone compiler does. The Page 6 (printed 6/28/99) oooobbbbjjjjcccc((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((OOOOcccctttt 22229999,,,, 1111999999997777)))) oooobbbbjjjjcccc((((1111)))) compiler will generate slightly different structures when this flag is used. The runtime is properly initializing both code variants, and binary object files compiled with or without this flag can be linked into the same program. ----oooobbbbjjjjcccc Treat files ending with .c as Objective C source files. Normally, files ending with a .m are assumed to be Objective C files, and .c files are assumed to contain plain C. ----oooottttbbbb Use object tables. This option causes the compiler to generate code that uses a double indirection for Object identifiers (handles, instead of pointers). It also links against runtime libraries called oooottttbbbbccccrrrrtttt....aaaa and oooottttbbbbppppaaaakkkk....aaaa,,,, because modules or libraries compiled with the -otb switch ccccaaaannnnnnnnooootttt be mixed with modules that were compiled without this option. ----ppppgggg Produce profiling information for use by ggggpppprrrrooooffff.... ----ppppiiiicccc Generate position independent code (PIC) on systems that support it, for building shared libraries. On some systems, this option translates to -fpic, on other systems (e.g. HP-UX) it is equivalent to +z. ----ppppppppiiii Include a set of compatibility header files in the default include path (for compatibility with Stepstone ICpak101). Also, allow classes to be defined using 3.x Productivity Products International syntax. This is used for compiling Brad Cox' Smalltalk to Objective-C translator. Implementations of classes start with '=' instead of the usual @implementation keyword. Superclasses still need to be declared with an @interface part, but the class that is being defined, itself, does not need an interface par t. ----ppppoooossssttttlllliiiinnnnkkkk Generate code for ppppoooossssttttlllliiiinnnnkkkk.... The default is not to do this. If you compile with this option on, you cannot combine object files for Objective C source with the usual link editor lllldddd.... Instead, if you use -postlink, you will be using our ppppoooossssttttlllliiiinnnnkkkk ((((1111)))) link editor Page 7 (printed 6/28/99) oooobbbbjjjjcccc((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((OOOOcccctttt 22229999,,,, 1111999999997777)))) oooobbbbjjjjcccc((((1111)))) processor, which does additional processing after linking. Programs compiled with postlink use a somewhat faster objcrt initialization, at the expense of longer link times. Use the combination of the flags -postlink and -retain to produce a file ____ppppoooossssttttllllnnnnkkkk....cccc that contains a list of all the Objective C modules that are linked into your program. ----pppprrrroooodddd Combine target independent independent TDF capsules into a TDF archive (a .ta file). This option is passed on to the ttttcccccccc ((((1111)))) compiler, the archive name can be set with -o. The resulting platform independent .ta file can be specified on the command line as an ordinary .a file. ----pppptttthhhhrrrreeeeaaaaddddssss Link against the library lllliiiibbbbpppptttthhhhrrrreeeeaaaaddddssss....aaaa and the runtime library oooobbbbjjjjccccrrrrtttttttthhhh....aaaa which is a thread-safe version of the oooobbbbjjjjccccrrrrtttt....aaaa runtime library (compiled with -DOBJCRT_PTHREADS). ----qqqquuuuiiiieeeetttt Disable copyright notice. Same as -q. ----rrrreeeettttaaaaiiiinnnn Do not remove intermediate C files. Normally, intermediate C code files are removed after oooobbbbjjjjcccc has made the C compiler compile them. ----rrrreeeeffffccccnnnntttt Generate code for reference counting. Assignments of object variables are translated towards calls to the iiiiddddaaaassssssssiiiiggggnnnn(((()))) function and code to increment and decrement reference counts is emitted for each compound statement. Only variables of type iiiidddd are being controlled by this option. ----ssssiiiioooouuuuxxxx Macintosh specific. Generates a SIOUX tool. Adds the Page 8 (printed 6/28/99) oooobbbbjjjjcccc((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((OOOOcccctttt 22229999,,,, 1111999999997777)))) oooobbbbjjjjcccc((((1111)))) libraries defined in the environment variable OBJCSIOUXLIBS. ----ssssttttaaaattttiiiicccc On systems that support dynamic linking and the -static compiler flag, this prevents linking with shared libraries. ----TTTTpppprrrreeeeffffiiiixxxx Use _p_r_e_f_i_x as prefix for temporary files (such as .P, .c, .i files) that are generated by the precompiler. For example, ----TTTT////ssssccccrrrraaaattttcccchhhh//// (note the trailing slash) will place files in the /scratch directory. Alternatively, the environment variable TTTTMMMMPPPPDDDDIIIIRRRR can be used to specify the directory that should be used. ----uuuunnnnddddeeeeffff Undefine all built-in C preprocessor symbols. This option is system specific, i.e. must be supported by the ccccpppppppp(1) preprocessor that is being used. ----uuuunnnnbbbbuuuuffff Run oooobbbbjjjjcccc1111 in unbuffered output mode. The default is to use block buffering. Unbuffered output mode is useful for debugging code generation of the precompiler. ----vvvveeeerrrrssssiiiioooonnnn Print version of compiler and quit. ----vvvv Print commands that are being executed by the driver script. Same as -verbose. ----vvvveeeerrrrbbbboooosssseeee Print commands that are being executed by the driver script. Equivalent to -v. ----wwww Suppress all warnings. Page 9 (printed 6/28/99) oooobbbbjjjjcccc((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((OOOOcccctttt 22229999,,,, 1111999999997777)))) oooobbbbjjjjcccc((((1111)))) ----WWWWlllleeeetttttttteeeerrrr,,,,ooooppppttttiiiioooonnnn Add ooooppppttttiiiioooonnnn to the list of options passed to the tool identified by lllleeeetttttttteeeerrrr.... Letter can be llll for the link editor, cccc for the C compiler, pppp for the C preprocessor, or oooo for the stage 1 Objective C compiler. For example, -Wp,-x passes the option -x to cccccccc when it is called with the -E flag to do preprocessing. ----wwwwCCCCllllaaaassssssssUUUUsssseeeeddddAAAAssssTTTTyyyyppppeeee Suppress warnings when class names are used as types. The compiler will translate pointers to classnames to "id". ----wwwwUUUUnnnnddddeeeeffffiiiinnnneeeeddddMMMMeeeetttthhhhoooodddd Suppress warnings for methods that are not prototyped. The compiler will assume that the return value and argument types of such methods is "id". ----WWWWaaaallllllll Passed on the GNU C compiler for enabling compiler warning messages. ----xxxxssssttttrrrr strings Run the (modified) BSD program xxxxssssttttrrrr(1) after running the Objective C compiler. This option can somewhat reduce the size of Objective C selector tables of the executable ( xxxxssssttttrrrr will extract selector strings out of the translated Objective C sources, assemble the strings in a file called "strings", and will cause the runtime to use a single, shared table of strings). This could also speed up runtime initialization as selectors don't have to be uniqued anylonger at startup. ----YYYYeeeennnnvvvv Use the specified environment. This is for the TenDRA ttttcccccccc compiler. Valid values are -Yansi, -Yposix, -Yunix95 etc. EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT PPPPaaaaggggeeee 11110000 ((((pppprrrriiiinnnntttteeeedddd 6666////22228888////99999999)))) oooobbbbjjjjcccc((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((OOOOcccctttt 22229999,,,, 1111999999997777)))) oooobbbbjjjjcccc((((1111)))) The most useful environment variable for setting options for oooobbbbjjjjcccc is probably OBJCOPT. It was introduced in version 1.3.7 of the compiler (port to Windows95). The environment variable OBJCDIR is kept for backward compatibility with older compilers. OBJCOPT The environment variable OBJCOPT can hold a list of options that is always prepended to the command line arguments of oooobbbbjjjjcccc.... For example, on UNIX, using the ksh shell : export OBJCOPT="-q -B$HOME/objc1.1.1" This would set the top location of the distribution, and would, in addition, always suppress copyright messages. On Windows95, the syntax is : set OBJCOPT=-q -B\objc OBJCDIR This variable can hold the top location of the oooobbbbjjjjcccc distribution. For example: for ksh: export OBJCDIR="$HOME/objc1.1.1" for csh: setenv OBJCDIR "$HOME/objc1.1.1" $OBJCDIR/bin and $OBJCDIR/man can be added to $PATH and $MANPATH respectively. OBJCPATHSEP This environment variable, if set, is a string that will be used as path separator instead of the default separator. Applies to both objc and objc1. TMPDIR If set, temporary files will be placed in this directory. The -T option overrides the value set by TMPDIR. Page 11 (printed 6/28/99) oooobbbbjjjjcccc((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((OOOOcccctttt 22229999,,,, 1111999999997777)))) oooobbbbjjjjcccc((((1111)))) CC The environment variable CC can optionally hold the name of a C compiler that is used to compile intermediate C files. CPP The environment variable CPP can optionally hold the name of a C preprocessor that is used to preprocess Objective-C input. The driver is normally configured with a default value. CPPFILTER The environment variable CPPFILTER can optionally hold the name of a C program that is to be ran after the C preprocessor. The tool will be invoked with two arguments : the name of the input file, and the name of the output file. OBJCRTMSG This environment variable is not strictly related to the compiler, but rather used by the runtime and hence, by all Objective-C programs. It can be set to either ssssttttddddeeeerrrrrrrr or a filename to which messages should be logged. For every message, class of the receiver and name of the selector are printed on a line. This file can quickly become very large; it is block buffered, unless OBJCRTDBG is set, in which case it is line buffered. OBJCRTDBG Like OBJCRTMSG, this variable is consulted by the runtime. It can be set to either ssssttttddddeeeerrrrrrrr or a filename to which messages of the ddddbbbbgggg(((()))) function should be logged. If this variable is set, output for OBJCRTDBG and OBJCRTMSG is line buffered. BBBBUUUUGGGGSSSS Send bug reports to objc-bugs@cys.de. Also see the objc-users mailing list (subscribe by sending email to objc-users-request@cys.de). SSSSEEEEEEEE AAAALLLLSSSSOOOO cc(1), postlink(1), cvtimport(1) Page 12 (printed 6/28/99) oooobbbbjjjjcccc((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((OOOOcccctttt 22229999,,,, 1111999999997777)))) oooobbbbjjjjcccc((((1111)))) Page 13 (printed 6/28/99)